home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / HAM_RAD / LOGGING / 2302.ZIP / CONTEST.ZIP / CONTEST.DOC < prev    next >
Text File  |  1990-01-12  |  23KB  |  518 lines

  1.         PC-HAM CONTEST.DOC Version 3.3 PAGE 1
  2.  
  3.  
  4.                                CONTEST Version 3.3
  5.  
  6.                  G3ZCZ AMATEUR RADIO CONTEST PACKAGE VERSION 3.3
  7.          
  8.                 (C) Copyright 1985, 1986, 1987, 1988, 1989, 1990 
  9.                                All Rights Reserved 
  10.  
  11.                                By Joe Kasser G3ZCZ
  12.                                     POB 3419,
  13.                                   Silver Spring,
  14.                               Md., 20918, USA.
  15.  
  16.         CONTEST is part of PC-HAM, a set of DATA Processing Amateur Radio 
  17.         programs  for the user of a microcomputer in Amateur  Radio.  The 
  18.         BASIC  language  programs may or may not be described  in  or  be 
  19.         based  on  programs described in the book, SOFTWARE  FOR  AMATEUR 
  20.         RADIO  written  by  Joe Kasser, G3ZCZ,  published  by  TAB  Books 
  21.         (Number 1560), Blue Ridge Summit, Pa., 17214, and available  from 
  22.         the  author. The DBASE3 programs perform database  operations  on 
  23.         logbook information.
  24.  
  25.              PC-HAM is written and supported by Joe Kasser, G3ZCZ.
  26.  
  27.         The program is distributed as a Shareware product. You may freely 
  28.         copy  and  share the product with your  friends,  associates  and 
  29.         other radio hams. If you decide to use the product, you are asked 
  30.         to become a registered user by sending  a QSL card and a  contri-
  31.         bution   to the author (suggested amount of $36.50 (ie.  half  of 
  32.         73)  or  equivalent in foreign currency  (See  registration  form 
  33.         below).
  34.  
  35.         The  contribution covers the cost of distribution of the  updated 
  36.         disk,  and  supports the continual development of  "Software  for 
  37.         Amateur  Radio".   Upon receipt of your  contribution,  you  will 
  38.         receive  one  free update disk ), mail (electronic  and  regular) 
  39.         support,  and notice of further releases.  The update  disk  will 
  40.         contain  any new versions of the software on this disk  plus  new 
  41.         software,  accompanying  the series of articles  currently  being 
  42.         written on the applications of data processing concepts of micro-
  43.         computers to amateur radio.
  44.  
  45.         Under  no circumstances may this product be sold  or  distributed 
  46.         with  another product without the express written  permission  of 
  47.         Joe Kasser, G3ZCZ.  
  48.  
  49.         Joe  Kasser,  G3ZCZ will only support unmodified copies  of  this 
  50.         software.  Your comments and suggestions for changes are  however 
  51.         welcome.  If you are the first to suggest a change that is imple-
  52.         mented,  you will be sent a complimentary copy of the  disk  with 
  53.         the change incorporated.
  54.  
  55.         PC-HAM CONTEST.DOC Version 3.3 PAGE 2
  56.  
  57.  
  58.                                     TABLE OF CONTENTS
  59.  
  60.         1.0  INTRODUCTION
  61.  
  62.         2.0  DURING THE CONTEST
  63.  
  64.         3.0  COMMANDS
  65.  
  66.              3.1  GRAB      (Function Key 1)
  67.              3.2  Band      (Function Key 2)
  68.              3.3  CALL      (Function Key 3)
  69.              3.4  *QRT      (Function Key 4)
  70.              3.5  RPT RX    (Function Key 5) 
  71.              3.6  Fudge     (Function Key 6)
  72.              3.7  XMT RPT   (Function Key 7)
  73.              3.8  /PX CHK   (Function Key 8)
  74.              3.9  LOG       (Function Key 9)
  75.              3.10 +MORE      (Function Key 10)
  76.              3.11 WATTS     (Function Key 1)
  77.              3.12 MODE      (Function Key 2)
  78.  
  79.              3.13 ?CLN      (Function Key 3)
  80.  
  81.              3.14 PRINT     (Function Key 4)
  82.  
  83.              3.15 OOPS      (Function Key 5)
  84.  
  85.         4.0  AFTER THE CONTEST
  86.  
  87.         5.0  SAMPLE DISK FILES
  88.  
  89.  
  90.  
  91.  
  92.         1.0  INTRODUCTION
  93.  
  94.         Contests  are  a  natural  application of  computers  in  amateur 
  95.         radio.  After  all   the purpose of a contest can  be  stated  as 
  96.         gathering  data  (the  calls and reports of stations  worked)  in 
  97.         such a way as to avoid  duplicates. When working  contests in   a 
  98.         manual   (non  computer)  mode,  if you desire to   avoid  dupli-
  99.         cates,  you  usually have to  keep two sets of records  for  each  
  100.         contact.   The log entry has to  be made, and a duplicate   sheet 
  101.         of some kind has  to be kept to  give real time notice of  poten-
  102.         tial  duplicate contacts.   
  103.  
  104.         The  use of a good contest logging program simplifies  the  paper  
  105.         work  during  and  after a contest and allows   the  operator  to  
  106.         concentrate  on  working  stations. 
  107.  
  108.         During the contest, the operator has only to perform the  follow-
  109.         ing tasks.  
  110.  
  111.         *    Enter the call sign of the station worked.  
  112.  
  113.         PC-HAM CONTEST.DOC Version 3.3 PAGE 3
  114.  
  115.  
  116.         *    Enter the  report received.  
  117.  
  118.         *    Tell the computer to log the  contact.  
  119.  
  120.         The  computer  takes care of the rest of the data  handling.  The  
  121.         computer thus performs the following tasks.     
  122.  
  123.         *    Keeps  a  check list in memory to notify the operator  if  a  
  124.              contact  has been made on the same (duplicate) or  an  other 
  125.              band.   
  126.  
  127.         *    Updates date and time information automatically.  
  128.  
  129.         *  Stores the contact data in a floppy disk file.  
  130.  
  131.  
  132.         Two versions  of  the  program  are  provided  on  this  disk  as 
  133.              described below.
  134.  
  135.         CONTEST.BAS  The   source   code  for  GWBASIC   or   the   BASIC 
  136.                     interpreter.
  137.  
  138.         CONTEST.TB  A  later  version, updated, modified  and  colorized.  
  139.                     This  version has been converted to  Borland's  Turbo 
  140.                     Basic.   You may customize the colors by editing  and 
  141.                     recompiling the program.
  142.  
  143.         CONTEST.EXE Compiled version of CONTEST.TB.  Run this one.
  144.  
  145.         2.0  DURING THE CONTEST
  146.  
  147.         The  contest  program on this disk maintains the check  list  for 
  148.         duplicates  in memory, logs all contacts to disk and can  if  de-
  149.         sired  print a running log of contacts and/all callsigns  to  the 
  150.         printer  as  the  contest progresses.  This  print  operation  is 
  151.         desirable in case of a power failure, or operator error in  which 
  152.         a contact was not logged by mistake.  The program also  maintains 
  153.         a  stack  of callsigns.  Each time you enter a call  sign  it  is 
  154.         placed  on  the top of the stack.  You may grab the call  of  the 
  155.         stack later as long as it is still in the stack.
  156.  
  157.         BEFORE  YOU  DO ANYTHING ELSE, SET THE CAPITALS KEY SO  THAT  ALL 
  158.         CHARACTERS ARE ENTERED IN CAPITAL LETTERS.
  159.  
  160.         The program is invoked by typing the word CONTEST.
  161.  
  162.         When  the  program begins, a sign on message such as  that  shown 
  163.         below will appear.  
  164.  
  165.                      G3ZCZ CONTEST LOGGING PROGRAM VERSION 3.3
  166.  
  167.  
  168.         IF TIME IS NOT SET TO UTC, STOP NOW AND SET THE CLOCK IN DOS
  169.  
  170.         At  this  time, if the clock has not been set to UTC  before  you 
  171.         PC-HAM CONTEST.DOC Version 3.3 PAGE 4
  172.  
  173.  
  174.         loaded  the program, break the sequence and return to DOS to  set 
  175.         the date and time to the correct UTC values.
  176.  
  177.         You  will then be requested to give the computer the name of  the 
  178.         file you wish be the log.  The computer checks the disk to see if 
  179.         the file exists.  If it does, the computer will load the data  in 
  180.         it  into the check list, and display the calls worked as it  goes 
  181.         along.   If there is no such file on the disk, the computer  will 
  182.         create  one.   You will then be asked about  your  running  print 
  183.         requirements. You have the option of printing the logged contacts 
  184.         and/or just the calls (as you enter them) as you go along.  Reply 
  185.         with the CAPITAL letters please as in the examples below.
  186.  
  187.         Enter name of lOG file (D:NAME) Log type .LOG Assumed ? FIELD85
  188.  
  189.         Do you want a running log printed out (Y/N) ? Y
  190.         Do you want CALL SIGNS printed out (Y/N) ? Y
  191.  
  192.         If the log file is new, the computer will prompt you to enter the 
  193.         Mode, Band and after a short pause, it will request you to  enter 
  194.         the   Transmitter  Power information before getting down  to  the 
  195.         contest.  
  196.  
  197.         If  you are loading an existing file, after a break for  example, 
  198.         the  computer  will  load the check list from the  log  file  and 
  199.         display the calls as it goes along.  When the log is loaded,  the 
  200.         computer  will  pause and wait for you to touch the  'ENTER'  key 
  201.         before  setting up the main screen.  A typical example  from  the 
  202.         FIELD85 log  is shown below.
  203.  
  204.          166          G4NWG         54019
  205.          167          G4TSH         55024
  206.          168          G4OVF         57001
  207.          169          G4EKT/P       55592
  208.          170          DF0WB/P       53
  209.         Waiting,touch ENTER to continue ?
  210.  
  211.         You  can see the entry number, followed by the call sign  of  the 
  212.         station  worked  and lastly the report received.   The  remaining 
  213.         data in the log file associated with each contact is there but is 
  214.         not displayed at this time.
  215.  
  216.         When the program begins a new contest log, you will be  presented 
  217.         with the following screen.
  218.  
  219.         PC-HAM CONTEST.DOC Version 3.3 PAGE 5
  220.  
  221.  
  222.         G3ZCZ CONTEST LOGGING PROGRAM VERSION 3.3          DUMMY    
  223.         -------------------------------------------------------------
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.         --------------------------------------------------------------
  239.                                      CURRENT ENTRY
  240.          1  90/01/06  0331 ?              20   SSB 100  00 59 - -
  241.  
  242.         QRU ?
  243.  
  244.         The top line contains the version of the program and displays the 
  245.         name of the disk file you are using as the log.  It is recommend-
  246.         ed that the name be somewhat representative of the contest.   Use 
  247.         names such as WPX87, ARRLDX86, FIELD85 and so on.
  248.  
  249.         The blank area following is where the last few contacts you  made 
  250.         will be displayed.  You thus have an ongoing display of the  last 
  251.         contacts .  It is very useful to see how you are doing and in the 
  252.         Worked  All  Europe  contest you can use that data  for  the  QTC 
  253.         information  (if you are located outside Europe). The call  stack 
  254.         will be shown overlaying this window.
  255.  
  256.         The  lower part of the screen contains the  CURRENT  ENTRY  data.  
  257.         This  is  the data concerning the contact in progress.   In  this 
  258.         case the next contact is the first or number 1, and the call data 
  259.         is blank because nothing has been entered.
  260.  
  261.         As  you work the contest you will pick up information from  other 
  262.         stations.   This information will consist of call signs  and  re-
  263.         ports.  In some contests (eg. The ARRL Sweepstakes) the report is 
  264.         relatively  complex, in others it is simple.  You do not know  in 
  265.         which order you will get the data for each contact.  This program 
  266.         thus lets you enter the data in any order.  You tell the computer 
  267.         which  piece  of data is going to be entered by typing  a  single 
  268.         letter followed by the 'ENTER' key.  
  269.  
  270.         In order to speed up that operation, the function keys have  been 
  271.         set up with those commands, and are displayed during the  contest 
  272.         for your convenience.
  273.  
  274.         PC-HAM CONTEST.DOC Version 3.3 PAGE 6
  275.  
  276.  
  277.         3.0  COMMANDS
  278.  
  279.         The   contest  logging program gives the operator  the  following 
  280.         choices. If you do not wish to use the function keys, you have to 
  281.         type the first letter followed by the 'ENTER' key.
  282.  
  283.              3.1  GRAB      (Function Key 1)
  284.  
  285.              This  command allows you to grab a call of the  stack.  When 
  286.              you  touch  the F1 key, you will be prompted for  a  number. 
  287.              Enter  the  number shown next to the callsign in  the  stack 
  288.              window  and that call will be grabbed.  This feature  allows 
  289.              you  to tune past a station and return to it,  entering  the 
  290.              call as you go, an not having to reenter it later.
  291.  
  292.              3.2  Band      (Function Key 2)
  293.  
  294.              Enters  the band information for the checklist and log.  Use 
  295.              the following designations for the different bands, 160, 80, 
  296.              40, 20, 15, 10, 6, and 2.
  297.  
  298.              NOTE, changing the band will clear the call and report  data 
  299.              elements form the display.
  300.  
  301.              3.3  CALL      (Function Key 3)
  302.  
  303.              Enters the Call of the station to be or being   worked. When 
  304.              the  call is entered, the computer will  perform a check  to 
  305.              see  if  that call has  already been worked and  if  so   on 
  306.              what  band. If the call has  been worked on the  band in use 
  307.              at  that  time it will also display the word  DUPLICATE  and 
  308.              BEEP  an audible  alarm.  The beep is a must at  0330  hours 
  309.              local time.   
  310.  
  311.              If  you change your mind, type the 'ENTER' key and the  call 
  312.              in the display will not be changed.
  313.  
  314.              3.4  *QRT      (Function Key 4)
  315.  
  316.              This   command terminates  the  program. It saves  the  data 
  317.              associated  with  the last  12 contacts in a file  with  the 
  318.              ".CHK"   extension so  that when the program  is  restarted,  
  319.              the  operator  will not even notice that a  break  occurred. 
  320.              The disk files are closed and any previous  log file present 
  321.              from the start  of the session is named as a backup file.
  322.  
  323.              Since  you  have  the potential to lose a  number  of  QSO's 
  324.              (while  recovering) if you invoke this command  by  mistake, 
  325.              the  computer  will ask you to verify that you meant  to  do 
  326.              what  you just asked for.  You will be prompted  to  confirm 
  327.              your request with the following message.
  328.  
  329.                             ARE YOU SURE ?
  330.  
  331.              At  this time, type the letter Y for "YES" followed  by  the 
  332.         PC-HAM CONTEST.DOC Version 3.3 PAGE 7
  333.  
  334.  
  335.              'ENTER'  key if you want to got QRT for a while, or  if  the 
  336.              contest is over.  Any other key will abort the sequence.
  337.  
  338.              3.5  RPT RX    (Function Key 5)
  339.  
  340.              Enter the Report received into the  log.   
  341.  
  342.              3.6  Fudge     (Function Key 6)
  343.  
  344.              This command is used to flag an erroneous log entry.   Since 
  345.              the  log on disk is a sequential file, and the log  data  is 
  346.              not double buffered by the program, once an entry is written 
  347.              to  the log, it is gone. This command deletes the call  from 
  348.              the list checklist and puts a "/*" entry  into the logbook. 
  349.  
  350.              Since  you have the potential to delete a QSO if you  invoke 
  351.              this command by mistake, the computer will ask you to verify 
  352.              that  you meant to do what you just asked for.  You will  be 
  353.              prompted to confirm your request with the following message.
  354.  
  355.                             ARE YOU SURE ?
  356.  
  357.              At  this time, type the letter Y for "YES" followed  by  the 
  358.              'ENTER'  key  if you want to fudge the  last  contact.   Any 
  359.              other key will abort the sequence.
  360.  
  361.              3.7  XMT RPT   (Function Key 7)
  362.  
  363.              Enter  the signal report Xmitted to the  other station  into 
  364.              the log.   
  365.  
  366.              3.8  /PX CHK   (Function Key 8)
  367.  
  368.              This   command  is used to scan the contents of   the  check 
  369.              list  for prefixes. You use  this  when  you are  sure  that 
  370.              you  have worked a station  but the computer tell  you  that  
  371.              you  haven't.  You may also use it to check if a prefix has   
  372.              been worked as a help in deciding if you want to get into  a 
  373.              pile  up or pass it  by.  NOTE however that the response  is  
  374.              not instantaneous. It takes a few  seconds to scan  the 
  375.              4000 slots in the check list. The  computer will prompt  you 
  376.              to enter  a prefix. If you want to look at all the calls  in 
  377.              the check list,  enter an asterisk (*) as the desired prefix 
  378.              and  you will get a list of every call in the check list  in 
  379.              the order in which they are hashed in the check list.   
  380.  
  381.              3.9  LOG       (Function Key 9)
  382.  
  383.              Enter the QSO information into the Log book/check list.  The 
  384.              data is written into the log file in ASCII format  delimited 
  385.              with commas. This makes it easy to modify with a word  proc-
  386.              essor and read into the program used by the second computer. 
  387.              You may also list the contents of the log file to the screen 
  388.              under DOS using the "TYPE" command.   
  389.  
  390.         PC-HAM CONTEST.DOC Version 3.3 PAGE 8
  391.  
  392.  
  393.              Logging a contact clears the call and updates the time data.
  394.  
  395.              THE  COMPUTER  WILL NOT LET YOU LOG THE QSO UNTIL  YOU  HAVE 
  396.              ENTERED BOTH A CALL SIGN AND A REPORT.  This traps one  type 
  397.              of error that can be made in the heat of the moment.
  398.  
  399.                   3.10 +MORE (Function Key 10)
  400.  
  401.              This command switches sets of function keys.
  402.  
  403.              3.11 WATTS     (Function Key 1)
  404.  
  405.              Enter   the Transmitter Power used  in  Watts into the  log-
  406.              book.   
  407.  
  408.              3.12 MODE      (Function Key 2)
  409.  
  410.              Enter   the  Mode used in the contest in the log.   You  may 
  411.              enter anything,  but the most commonly used ones are SSB and 
  412.              CW.   
  413.  
  414.              3.1 3 ?CLN      (Function Key 3)
  415.  
  416.              This  command clears the screen dialogue  lines. It is  nor-
  417.              mally  used rarely, only in the event that the BASIC  inter-
  418.              preter  generates  an error message  in response to  a  user  
  419.              input.  The typical one normally seen  is "REDO FROM  START" 
  420.              which  results from an  alphabetical response  to the   BAND  
  421.              interrogation,   where BASIC is looking for a number, not  a 
  422.              string.                     
  423.  
  424.              3.14  PRINT         (Function Key 4)
  425.  
  426.              This command allows you to turn the printer on and off.
  427.  
  428.              3.15  OOPS          (Function Key 5)
  429.  
  430.              This  command  is used after some catastrophe in  which  the 
  431.              numbers  have gotten out of sequence.  You use it to  add  a 
  432.              number to the one displayed on the screen.
  433.  
  434.         4.0  AFTER THE CONTEST
  435.  
  436.         When  the  contest ends, or you take a break, the  computer  will 
  437.         close  out the log and 'CHK' files and ask you if the contest  is 
  438.         over.  The following messages will be displayed.
  439.  
  440.         SAVING LAST ENTRY STRINGS BEFORE CLOSING
  441.         Is the contest over (Y/N) ?
  442.  
  443.         If you reply with the letter N for NO, the program will end.   If 
  444.         the contest is over, and you reply with the letter Y, the program 
  445.         will  proceed  to process the contest log data.  It  will  delete 
  446.         entries  flagged  for  deletion and optionally  will  number  the 
  447.         contacts  in  the comments column.  The program prompts  for  in-
  448.         PC-HAM CONTEST.DOC Version 3.3 PAGE 9
  449.  
  450.  
  451.         structions as to the number option as follows.
  452.  
  453.         CONVERTING (CLEANING UP) CONTEST LOG TO STANDARD LOG
  454.         Do you want the contacts numbered (Y/N) ? N
  455.  
  456.         The  computer will put a dummy entry into the first  position  of 
  457.         the  log  identifying the contest.  It will thus request  you  to 
  458.         give  it the name of the contest.  You must use a name that  con-
  459.         tains 10 or fewer characters.  The questions is posed as follows.
  460.  
  461.         What is the name of the contest ? FIELD85
  462.  
  463.         The   program first generates a reference entry for  the  contest 
  464.         log.   It then reads each line of  log  information, strips   the 
  465.         report part from the comments and  puts it into the report  space 
  466.         and  if it as been so instructed, adds the serial number of   the 
  467.         contact into the comments space.   When the program has done  its 
  468.         job,  the  original  log has been renamed  with   a  ".RUN"  file  
  469.         extension   while  the converted log data file has the  extension 
  470.         ".LOG".
  471.  
  472.         The  computer generates a running display as the data  processing 
  473.         job proceeds, a typical example of which is shown below.
  474.  
  475.         85/09/08      -CONTEST               SSB           FIELD85
  476.         85/09/07 1646 G4ANT/P    20  59  59  SSB  200  - - 064
  477.         85/09/07 1647 DF0KD/P    20  59  59  SSB  200  - - 131
  478.         85/09/07 1648 G4AAX/P    20  59  59  SSB  200  - - 086
  479.         85/09/07 1649 YU4EXC/P   20  59  59  SSB  200  - - 198
  480.         85/09/07 1651 DF0SSB/P   20  59  59  SSB  200  - - 160
  481.         85/09/07 1659 G3WAS/P    20  59  59  SSB  200  - - 089
  482.         85/09/07 1703 YU4EZC/4   20  59  59  SSB  200  - - 219
  483.          -------
  484.         85/09/08 1305 G4NWG      15  54  53  SSB  200  - - 019
  485.         85/09/08 1306 G4TSH      15  55  59  SSB  200  - - 024
  486.         85/09/08 1307 G4OVF      15  57  53  SSB  200  - - 001
  487.         85/09/08 1323 G4EKT/P    20  55  59  SSB  200  - - 592
  488.         85/09/08 1330 DF0WB/P    20  53  53  SSB  200  - -
  489.  
  490.          10 Entries were corrected/deleted
  491.         OK
  492.  
  493.         Note that the date is set to the date at the end of the  contest, 
  494.         not the date at the start of the contest.  When the job is  over, 
  495.         you will be shown how many entries were corrected or deleted.
  496.  
  497.         You may examine the log with a word processor (non-document  mode 
  498.         please),  or better still APPEND it to the PC-HAM DBASE3  logging 
  499.         package  for  further   processing.  Since  the  logging  package 
  500.         processes the data so well, a program in BASIC to display the log 
  501.         was deemed unnecessary.
  502.  
  503.         5.0  SAMPLE DISK FILES
  504.  
  505.         The   following  sample files of an extract from the  1985  Field  
  506.         PC-HAM CONTEST.DOC Version 3.3 PAGE 10
  507.  
  508.  
  509.         Day  contest   log  are  presented on the disk as   an   aid   to 
  510.         understanding the operation of the CONTEST package.
  511.  
  512.         FIELD85.RUN  As run log of contest.
  513.         FIELD85.LOG  Log, ready for conversion to .DBF format.
  514.         FIELD85.CHK  Last few entries in log.
  515.         FIELD85.DBF  Log, in DBASE2 data base format.
  516.         FIELD85.NDX  Index file for DBASE2 log database.
  517.  
  518.